Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Editing Movies / Low-Level Movie-Editing Functions

CopyMovieSettings

The CopyMovieSettings function copies many settings from one movie to another, overwriting the destination settings in the process.

pascal OSErr CopyMovieSettings (Movie srcMovie, Movie dstMovie);

srcMovie

Specifies the source movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

dstMovie

Specifies the destination movie for this operation. The CopyMovieSettings function uses the settings from the source movie, which is specified by the srcMovie parameter, to replace the current settings of this movie.

DESCRIPTION

The CopyMovieSettings function copies the

• preferred rate and volume
• source clipping region
• matrix information
• user data

If you want to work with specific characteristics, you can use the Movie Toolbox functions that allow you to manipulate movie settings individually. These functions are described in "Functions That Modify Movie Properties" beginning on page 2-142.

This function does not copy the movie's contents. To work with movie contents, you should use the segment editing functions described in "Low-Level Movie-Editing Functions" beginning on page 2-240.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

Memory Manager errors